AgentDebugX: An Open-Source Toolkit for Failure Observability, Attribution, and Recovery in LLM Agents
AgentDebugX: LLM Agent 闭环调试与根因修复工具包
🧭 Agent 调试 · 根因分析与修复 ★ 深度解读
University of Illinois Urbana-Champaign · University of Toronto · Google · Stanford University
提出闭环调试框架AgentDebugX，其多轮根因诊断方法DeepDebug在Who&When上严格归因准确率28.8%优于单次方案21.7%，在GAIA上单次重试修复13/73失败任务。
📌 工作参考价值（4 点）
- 闭环植入推荐Agent质量保障：可将Detect-Attribute-Recover-Rerun流程嵌入推荐系统的Agent执行链路（如多轮对话推荐、商品搜索Agent），自动检测表象失败并回溯到真正决策错误步骤，将根因分析作为线上兜底策略。
- 根因分析用于模型迭代：DeepDebug的多轮全局扫描、结构引导探查与交叉验证机制可直接迁移，用于诊断推荐失败（如错误召回源头、排序打分支离），产出带证据的诊断报告，替代人工日志分析，加速Bad Case修复。
- 可移植轨迹表示降本增效：框架无关的AgentTrajectory格式支持跨LangGraph、CrewAI等常用Agent框架，适合多团队共享同一诊断工具；Error Hub可积累推荐Agent的失败-诊断-修复三元组，形成团队知识库，用于回归测试和长尾错误模式发现。
- 成本可控的渐进诊断：采用“简单规则→单次LLM读取→多轮DeepDebug”的成本递增路径，可根据任务复杂度动态选择诊断深度；对于推荐Agent，高频短链任务用轻量检查，长链多跳任务用DeepDebug避免定位偏差，工程上易于落地。